home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / prgtools / mint / lib / mntsox46.zoo / 00readme next >
Encoding:
Text File  |  1995-08-14  |  3.4 KB  |  92 lines
  1. MiNT library for Sozobon C eXtended version, patchlevel 46.
  2.  
  3. This is a port of Eric Smith's MiNT library to Sozobon C eXtended
  4. version, based on Dave Gymer's original port.  It replaces the files
  5. libc.a, libci.a and crt0.o from the original SozobonX distribution, and
  6. includes a simple termcap library.
  7.  
  8. NOTE:  As of patchlevel 46, the MiNTlibs port for Heat-n-Serve C is no
  9. longer supported.  Maintaining ports for two compilers is tricky enough,
  10. and HSC is now several years out of date.  If you're interested in
  11. taking over maintenance of the HSC port, please contact me at the
  12. address below.
  13.  
  14. NOTE:  This port requires SozobonX version 2.00x24 or higher (as
  15. displayed by `hcc -V'), as it assumes IEEE floating point support.  As
  16. of this writing, the latest version of SozobonX can be obtained via
  17. anonymous FTP from ftp.fu-berlin-de:/pub/atari/programming/sozobon.
  18.  
  19. A reminder, you _will_ need the pl46 include files to use this library.
  20. These can be found where you found this archive, in the file
  21. mntinc46.zoo or similar.
  22.  
  23. WHAT'S HERE:
  24.  
  25.     00readme
  26.     This file.
  27.     libc.a
  28.     libci.a
  29.     crt0.o
  30.     MiNT-aware replacements for the SozobonX distribution files of
  31.     the same name.
  32.     libtermcap.a
  33.     A simple termcap library.
  34.     libsort.ttp
  35.     A utility program that sorts an object library into optimal
  36.     linking order.  You won't need this program unless you want to
  37.     rebuild the library from the sources.
  38.     patch/
  39.     Include files that had to be modified for this port.
  40.  
  41. IF YOU JUST WANT TO USE IT:
  42.  
  43. To get yourself up and running with the MiNTlibs, do the following:
  44.  
  45. 0)  Obtain and install the MiNT include files for this version.  Where
  46.     you should install them depends on how you specify to `cc' where
  47.     your include files live.  If you use the $INCLUDEDIR/$LIBDIR
  48.     environment variables, install the headers in the directory
  49.     ${INCLUDEDIR}/mint.  If you use the $INCLUDE/$LIB environment
  50.     variables, install the headers in any directory specified in
  51.     $INCLUDE, preferably as close to the front as possible.
  52.  
  53. 1)  Copy the files libc.a, libci.a, crt0.o and libtermcap.a to the
  54.     appropriate directory.  Again, this depends on how you specify to
  55.     `cc' where your library files live.  If you use the
  56.     $INCLUDEDIR/$LIBDIR environment variables, copy the files to the
  57.     directory ${LIBDIR}/mint.  If you use the $INCLUDE/$LIB environment
  58.     variables, copy the files to any directory specified in $LIB,
  59.     preferably as close to the front as possible.
  60.  
  61. 2)  Replace the following files in the MiNT header directory with the
  62.     corresponding files in the patch/ directory in this package:
  63.  
  64.     compiler.h
  65.     falcon.h
  66.     mintbind.h
  67.     osbind.h
  68.     signal.h
  69.  
  70. And you're ready to roll!  If you use $INCLUDEDIR/$LIBDIR, use the
  71. --mint flag to compile with the MiNTlibs.
  72.  
  73. IF YOU WANT TO PLAY WITH IT:
  74.  
  75. There are, unfortunately, no source patches distributed with this
  76. package, as the diffs for SozobonX are rather heavily intertwined with
  77. the diffs for C68.  Hopefully this will all be cleared up by the next
  78. major MiNTlibs release.
  79.  
  80. DISCLAIMER:
  81.  
  82. What, you were expecting an ironclad guarantee of performance? ;)  Okay,
  83. while I have built several large programs with this library with no
  84. problems, I can't guarantee that there aren't still a few bugs lurking
  85. around in the code.  Caveat emptor, use at your own risk, and all that
  86. jazz.  And if you should happen to find a bug, please notify me at the
  87. address below.
  88.  
  89. Have fun!
  90.  
  91. Scott Bigham                dsb@cs.duke.edu
  92.